home *** CD-ROM | disk | FTP | other *** search
/ Top 101 Multimedia Shareware '93 / Top 101 Multimedia Shareware 1993.iso / movingvg / pyro.doc < prev    next >
Text File  |  1987-10-24  |  5KB  |  132 lines
  1.                     PYRO - A Simulated Pyrotechnics Display
  2.                     ---------------------------------------
  3.  
  4.                             (c) 1987  K.G. Shields
  5.  
  6.  
  7. Program PYRO utilises the power of an IBM AT compatible and the colour graphics
  8. capability of an EGA display to produce a realistic simulation of a
  9. Pyrotechnics (fireworks) display.
  10.  
  11.  
  12. Requirements
  13. ------------
  14. An AT compatible (preferably running at 8 Mhz)
  15. An EGA compatible display card
  16. A colour display
  17.  
  18. PYRO has been tested on a variety of machines running at 8 and 10 Mhz. 
  19. Although optimised to give the best effect on an 8 Mhz machine, it still gives
  20. quite acceptable results on the faster processors.  (For a good display on very
  21. fast machines the program may be modified by inserting a suitable delay in the
  22. innermost loop of the move_points function.)  When running at the correct
  23. speed, one complete Pyrotechnics show will take about four minutes to execute. 
  24. Most PC and XT compatibles are not fast enough to give a realistic display,
  25. however future plans for PYRO include a simplified version that will run on a
  26. PC/XT and be capable of driving a CGA display.
  27.  
  28.  
  29. Method of Use
  30. -------------
  31. Like a real fireworks display, PYRO is really meant to be viewed in the dark. 
  32. For the most realistic effect, first darken the room as much as possible and
  33. cover or turn off any LEDs or pilot lights on the computer and keyboard.  If
  34. darkening the room is too difficult PYRO will still give a convincing display
  35. by normal room lighting, but I recommend viewing it in the dark at least once
  36. to experience the full impact.
  37.  
  38. Put the PYRO disk in your A drive and make A: the default drive.  To execute
  39. PYRO to produce one complete Pyrotechnics presentation, enter
  40.  
  41.                pyro
  42.  
  43. at the DOS prompt.  Alternatively, the program may be made to run continuously
  44. by entering
  45.  
  46.                pyro c
  47.  
  48. instead.  To terminate the show immediately at any time hit the escape key. For
  49. a more graceful exit press any other key and the program will stop after
  50. completing all currently active sequences.
  51.  
  52.  
  53. Technical Details
  54. -----------------
  55. The program is written in Turbo C and compiles using default options.  To
  56. achieve the required speed, the EGA registers and memory are accessed directly. 
  57. In general, PYRO works by generating points and allowing them to continue in
  58. motion under the effect of simulated gravity.  The attributes of a point
  59. include position, velocity, size, colour, lifetime, and rate of fade at the end
  60. of its life.  Most attributes are generated randomly for each point, but the
  61. various effects are achieved mainly by manipulating the limits within which
  62. each attribute may lie.
  63.  
  64. There are five different effects currently programmed:
  65.  
  66. Spurt          Produces intermittent eruptions of coloured sparks which fill
  67.                the sky then fall gently to earth
  68.  
  69. Flare          A continuous stream of sparks emitted at high speed which fade
  70.                quickly before they begin to fall
  71.  
  72. Burst          A starburst of brightly coloured points complete with sound
  73.                effects
  74.  
  75. Rocket         A skyrocket which leaves behind a diffuse trail.  Most end in a
  76.                starburst but for realism a percentage of 'fizzlers' simply fade
  77.                away to nothing.
  78.  
  79. Roman Candle   A large fiery ball shoots skyward, leaving a short, quickly
  80.                fading trail.  The ball explodes in a large burst that sometimes
  81.                seems to fill the entire sky.
  82.  
  83.  
  84. Files on the PYRO Disk
  85. ----------------------
  86. PYRO.C         The complete source code of the program written in Turbo C
  87. PYRO.EXE       The program in executable form
  88. PYRO.DOC       This file, the documentation of PYRO
  89. PYROLAB.PCX    'Paintbrush' file to produce a colourful floppy disc label, if
  90.                you have the means to print it.
  91.  
  92.  
  93. Future Plans
  94. ------------
  95. This initial version of PYRO was produced as an entry in the 'Your Computer'
  96. Microsoft Computer Program Art Exhibition and in this context it is complete. 
  97. However when time permits I still intend to develop the concept further. 
  98. Likely future enhancements include
  99.  
  100. .  Inclusion of more effects.  (Catherine wheels are next - my wife insists!)
  101.  
  102. .  Ability to automatically sense processor speed and adjust delay loops to
  103.    compensate if necessary.
  104.  
  105. .  A simplified version which will be able to use a CGA display and will run at
  106.    sufficient speed on a PC or XT.
  107.  
  108. .  Addition of a suitable title screen.
  109.  
  110. .  Ability to read a script file so that you can customise your own display.
  111.  
  112.  
  113.  
  114.  
  115. Please direct any comments, enquiries or suggestions to
  116.  
  117.                               Kelvin G. Shields,
  118.                               21 Sirocco Street,
  119.                               Jamboree Heights,
  120.                               Queensland, 4074.
  121.  
  122.                               (07) 376 8383 (A/H)
  123.  
  124.  
  125.  
  126. Unless the written permission of the author is obtained beforehand, program
  127. PYRO may not be sold for any sum in excess of the normally accepted charges for
  128. copying and distributing public domain software, nor may it be used in any
  129. other manner for direct commercial gain, nor may the whole or any part of it be
  130. incorporated into any other item of computer software.
  131.  
  132.